package org.dromara.common.json.handler;

import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.SerializerProvider;
import com.fasterxml.jackson.databind.annotation.JacksonStdImpl;
import com.fasterxml.jackson.databind.ser.std.NumberSerializer;

import java.io.IOException;


/**
 * @Author 刘武贵
 * @Date 2024/8/15 22:00
 * @Description 功能描述：超出 JS 最大最小值 处理
 */
@JacksonStdImpl
public class BigNumberSerializer extends NumberSerializer {

    /**
     * 根据 JS Number.MAX_SAFE_INTEGER 与 Number.MIN_SAFE_INTEGER 得来
     */
    /**
     * 定义JavaScript中的最大安全整数
     */
    private static final long MAX_SAFE_INTEGER = 9007199254740991L;

    /**
     * 定义JavaScript中的最小安全整数
     */
    private static final long MIN_SAFE_INTEGER = -9007199254740991L;

    /**
     * 提供实例
     */
    public static final BigNumberSerializer INSTANCE = new BigNumberSerializer(Number.class);

    /**
     * 构造函数，初始化BigNumberSerializer对象
     *
     * @param rawType 表示要序列化的数字类型的Class对象
     *               该参数允许创建具有特定Number子类型（如Integer、Long等）的序列化器
     *               通过这种方式，可以针对不同的Number类型提供定制化的序列化逻辑
     */
    public BigNumberSerializer(Class<? extends Number> rawType) {
        super(rawType);
    }

    /**
     * 将数值序列化为JSON字符串。当数值超出JavaScript安全整数范围时，会将其转换为字符串形式，
     * 以避免在JavaScript中丢失精度。
     *
     * @param value 要序列化的数值对象
     * @param gen 用于输出JSON的生成器
     * @param provider 序列化提供者，可用于获取序列化配置
     * @throws IOException 如果在序列化过程中发生错误
     */
    @Override
    public void serialize(Number value, JsonGenerator gen, SerializerProvider provider) throws IOException {
        // 超出范围 序列化位字符串
        // 检查数值是否在JavaScript安全整数范围内
        if (value.longValue() > MIN_SAFE_INTEGER && value.longValue() < MAX_SAFE_INTEGER) {
            // 如果在范围内，调用超类方法进行默认序列化
            super.serialize(value, gen, provider);
        } else {
            // 如果超出范围，将数值转换为字符串以保持其在JavaScript中的准确性
            gen.writeString(value.toString());
        }
    }
}
